home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / gen / boxer / boxer.doc next >
Text File  |  1993-05-01  |  5KB  |  168 lines
  1.                 --- Boxer 0.1   M.Miller 4/25/93 ---
  2.  
  3.  
  4. Description:
  5.   Boxer is a simple object generator for POV-Ray 1.0. Boxer can create 
  6.   arrays of round corner tiles with grout, 3D arrays of square or round 
  7.   cornered boxes, 3D arrays of tubular boxes, or 3D arrays of spheres.
  8.   
  9.  
  10. Run:
  11. Boxer.EXE:
  12.   Choose: (A)Box Array  or (B)Tiles
  13.  
  14. - (A)Box Array
  15.   Entering an "A" will expand your choices to four types of objects: 
  16.   Enter an r, f, b, or q
  17.  
  18.   (R)R_Box   -  a round cornered box
  19.   (F)Frame   -  a tubular framed box
  20.   (B)Box     -  standard square edged box
  21.   (Q)QSphere -  sphere
  22.  
  23. - The next three inputs will create the size of the chosen object:
  24.  
  25.   (X)Width of Box  - Total unit width of object in the X direction
  26.   (Y)Height of Box - Total unit height of object in the Y direction
  27.   (Z)Depth of Box  - Total unit depth of object in the Z direction 
  28.  
  29. - Round Edge Radius of Box: - 
  30.      this input is used for both the (R)R_Box and (F)Frame. A number 
  31.      of 10 will round a (R)R_Box on all edges, including corners, to a 
  32.      radius of 10. If (F)Frame was chosen as the object, a number of 10 
  33.      will create a tubular framed box with all tubes 10 in radius, ie: 
  34.      a cylinder diameter of 20.
  35.   
  36.      Round Edge Radius of Box can be left blank if a (B)Box or (Q)QSphere
  37.      was chosen.  
  38.  
  39. - Number of Boxes across:
  40.      The amount of objects across in the X direction. A number of 3 will 
  41.      create three objects in a row.
  42.  
  43. - Number of Boxes down:
  44.      The number of object rows in the Y direction. A number of 3 will 
  45.      create three rows of objects.
  46.  
  47. - Number of Box Arrays Deep:
  48.      The number of object Arrays in the Z direction. A number of 3 will 
  49.      create three arrays.
  50.  
  51.      Example: 3 object in the (X) direction * 3 Rows = 9 objects or (1 Array)
  52.      1 Array * 3 Box Arrays deep = 27 object
  53.  
  54. - Gap Between Objects:
  55.      The unit distance between each object, or each row, or each array
  56.  
  57. - Create Random textures for objects: 
  58.      Answer "Y" if you would like a random texture gererated for each object.
  59.      The "built-in" random texture generator will pick a solid color or 
  60.      a procedual texture: ie: wood, marble, bozo, onion, ect. and produces 
  61.      random color_maps for each procedual texture. It will will also randomize
  62.      the turbelence, ambient, diffuse, phong, phong_size, reflection. If a
  63.      random alpha was produced for solid colors, a random refraction is
  64.      created.
  65.      
  66.      Answer (N) or leave blank if you would like Boxer to produce two
  67.      Default textures:
  68.      - Box_Texture1 will texture all even numbered objects
  69.      - Box_Texture2 will texture all odd numbered objects
  70.      * An odd number of objects across will create a "checker" pattern
  71.        across the rows. An even number of objects aross will create a
  72.        striped effect:
  73.             Odd across:                Even Across:    
  74.           
  75.             X  O  X  O  X              X  O  X  O  X
  76.             O  X  O  X  O              X  O  X  O  X
  77.             X  O  X  O  X              X  O  X  O  X
  78.             O  X  O  X  O              X  O  X  O  X
  79.             X  0  X  O  X              X  O  X  O  X
  80.  
  81. - Object Name
  82.      Over-writes the default object names. Handy if more than one
  83.      array is included in a scene.
  84.  
  85. - File Name:
  86.      Boxer creates 3 files
  87.      By default - if no name is given:
  88.  
  89.          - box.DEC  - contains declares of objects & textures 
  90.          - box.INC  - composite of object arrays
  91.          - box.POV  - scene file with lights, adjusted camera & "includes"
  92.                       
  93.  
  94. ***** this ends the options for (A)Box Array
  95.  
  96.  
  97.  
  98. - (B)Tiles
  99.  
  100. - The next two inputs will create the size of the Tile:
  101.  
  102.   Width of one Tile  - Total unit width of tile in the X direction
  103.   Height of one Tile - Total unit height of object in the Y direction
  104.  
  105. - Round edge radius of Tile:
  106.     Rounds all edges of tile, including corners.
  107.     For tile walls, a 6" x 6" ceramic tile has an edge radius of about .2            
  108.  
  109. - Number of Tile across:
  110.     Number of tiles in a row in the X direction
  111.  
  112. - Number of Tile down:
  113.     Number of tile rows in the Y direction
  114.     
  115. - Grout Gap between Tiles:
  116.     The unit distance between each tile and each row.
  117.  
  118.     A default "grout" box object is written at the end of the final 
  119.     bounded composite of tiles. This grout box is equal to the total
  120.     width & height of the tile array and is translated in the Z direction =
  121.     to the radius of the rounded edge with a thickness = to the radius.
  122.  
  123. - File Name:
  124.      Boxer creates 3 files 
  125.      By default - if no name is given:
  126.  
  127.          - box.DEC  - contains declare of single tile & texture 
  128.          - box.INC  - composite of object arrays
  129.          - box.POV  - scene file with lights, adjusted camera & "includes"
  130.  
  131. * NOTE: Tiles can not be produced with random textures. The default textures 
  132.       produced for tiles follow the same rules as the default textures for 
  133.       Box Arrays. 
  134.  
  135.  
  136.  
  137.       
  138.  
  139.  
  140.  
  141.  
  142.  
  143.       
  144.      
  145.   
  146.  
  147.     
  148.   
  149.   
  150.  
  151.  
  152.  
  153.   
  154.   
  155.   
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.